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TRACE MANAGEMENT IN CLIENT-SERVER APPLICATIONS 

BACKGROUND 

The present invention relates to data processing by a computing device, and more 
particularly to trace management techniques in client-server applications. 

5 

User interfaces facilitate the interaction between humans and computers by inviting 
and responding to user input. User interfaces come in many varieties, and are designed to 
work in concert with application programs. A common scenario involving user interfaces is a 
network application, where a network connects an application program running on a server 

10 and one or more user interfaces running on client devices. The client/server relationship is 
one in which a server provides services to the client devices. Both the client devices and the 
server typically have a network interface for accessing networks such as a local area network 
(LAN), a wide area network (WAN), or the Internet. 

In a network environment, a common client device is a personal computer and a 

15 common client program with a user interface is a Web browser. The client program enables 
networked communication between the client device and a server using a data transfer 
protocol, e.g., the Hypertext Transfer Protocol (HTTP), to exchange files, images, or 
programs. HTTP is a request/response-type protocol that specifies how the client device and 
the server communicate with each other. The server may receive a request from the client 

20 device using HTTP, respond to the request, and then close the connection. HTTP is a 

stateless protocol, meaning that each time a client device requests a Web page, the server will 
respond to the request independently of any previous requests by the client device, and 
without recording the request. 

The contents of a file transmitted from the server and intended for display in the 

25 client program 4 on the client device may be marked up with Hypertext Markup Language 
(HTML) code or Extensible Markup Language (XML) code. HTML is a language that is 
used to describe the structure of a document, such as a Web page. Client programs interpret 
HTML code to determine how to display the information contained in the page. A user may 
request a Web page from a server by clicking on a hyperlink or specifying a Uniform 

30 Resource Locator (URL) string. A URL can be used to identify the address of a file that may 
be accessed on the Internet. The address identifies the Web server on which the file is stored 
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and the directory in which the file is located. When the server receiving the URL request 
finds the sought Web page, the server sends the page to the client device so that the client 
device can use that Web page, for example, by generating a display for a user according to 
the Web page/ 

5 

SUMMARY OF THE INVENTION 
The techniques described herein provide methods and apparatus, including computer 
program products, for trace management techniques in client-server applications. 

In general, in one aspect, there is a computer program product, tangibly embodied in 
10 an information carrier, for generating an integrated trace output file on a system having a first 
computing device and a second computing device. The computer program product is 
operable to cause data processing apparatus to generate a first trace output at a first 
computing device, receive a second trace output from a second computing device, and 
generate an integrated trace output file by combining the second trace output with the first 
15 trace output. The first computing device may be a server and the second computing device 
may be a client. 

In other examples, the computer program product has one or more of the following 
features. An agent (e.g., employing JavaScript code) can be provided for detecting an event 
at the second computing device. The product can identify a severity level for event detection 

20 at the first computing device, and detect an event having the identified severity level. The 

product can also identify a severity level for event detection at the second computing device, 
and detect an event having the identified severity level. The severity levels indicate whether 
the trace outputs include an error message, a warning message, an information message, or a 
debug message. The second trace output can be integrated with the first trace output in a 

25 chronological order. An active component trace output can be sent from the second 

computing device to the first computing device for integration with the first trace output. 
The integrated trace output can be displayed on the second computing device in a separate 
browser window. 

In another aspect, there is a method for detecting an event at a client, generating a 
30 client-side trace output in response to the event detection at the client, and transmitting the 

client-side trace output to a server for integration with a server-side trace output. The method 
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can include detecting the event at a client device while a user is interacting with an 
application program executing on the server. The method can also include detecting an event 
at the server while the user is interacting with the application program, generating the server- 
side trace output in response to the event detection at the server, and integrating the server- 
side trace output with the client-side trace output to generate a single trace output file. 

In another aspect, there is a system for generating an integrated trace output file. The 
system includes a client agent having a detection module configured to detect an event at a 
client, a generation module configured to generate a client-side trace output in response to 
the event detection at the client, and a communication module configured to transmit the 
client-side trace output to a server. The system also includes a server agent having a 
detection module configured to detect an event at the server, a generation module configured 
to generate a server-side trace output in response to the event detection at the server, a 
communication module configured to receive the client-side trace output from the client, and 
an integration module configured to generate an integrated trace output file by combining the 
client-side trace output with the server-side trace output. In other example, the system has 
one or more of the following features. The system can have a client program including the 
client agent arid an application program including the server agent. 

The details of one or more examples are set forth in the accompanying drawings and 
the description below. Further features, aspects, and advantages of the invention will become 
apparent from the description, the drawings, and the claims. 

BRIEF DESCRIPTION OF THE DRAWINGS 
FIG 1 shows a trace management process. 

FIG 2 is a block diagram of a computing system that allows a user to interact with a 
software application over a network. 

FIG 3 is a block diagram of a computing system that allows multiples users to 
interact with a software application over a network. 

Like reference numbers and designations in the various drawings indicate like 
elements. 
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FIG 1 shows a trace management process 100 implemented in a computer program 
for integrating trace outputs generated by a client and a server into a single trace output file. 
As described in more detail below, the client and the server are computers, interacting 
through a communications network, that have a client-server relationship arising by virtue of 
5 computer programs running on the respective computers. Generally, the server computer 
executes a server application program and the client computer serves as an interface for a 
user to interact with the server application program executing on the server. The client (e.g., 
executing a user interface application) receives input from a user, transmits that input to the 
server computer, and displays output generated from the server computer in response to that 

10 input. Due to possible delays in the communications network, requiring a server round-trip 
(i.e., from the client to the server and back to the client) in order to generate a display in 
response to each user input can lead to a delayed and frustrating experience for the user. 

As a result, user interface applications on the client computers are becoming more 
sophisticated and doing more processing of data at the client independently, without relying 

15 on a round trip to the server to react to the user input. For example, a client-side framework 
executing on the client computer can process data changes and handle some errors 
independently, without requiring a server round-trip. Because of this independent processing 
and client portion sophistication, the server application program no longer is involved in each 
processing step. 

20 For debugging situations, the server application program does not know, in a machine 

sense, what is happening on the client during this independent processing. To aid the 
application developer in the debugging process, a trace program executed by a client agent 
and a server agent can be used to generate trace outputs. In process 100, a client agent 
executing the trace program monitors (102) the client program and generates (104) a client- 

25 side trace output for processing done on the client computer. Similarly, a server agent 

executing the trace program monitors (108) the server application program and generates 
(1 10) a server-side trace output for processing done on the server computer. The server 
computer integrates (112) the server-side trace output with the client-side trace output that 
the client agent transmits (106) to the server computer. 

30 The client agent and the server agent (executing the trace program) search for the 

occurrences of certain events. Upon the occurrence of these events (e.g., a non- fatal error), 
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one or more trace statements are generated, which may include a state of the client program 
or the server application program at the occurrence of each such event, and the address of the 
program instruction at the time of the occurrence of the event. These trace statements are 
then outputted as a trace (referred to as a "client-side trace output" or a "server-side trace 
5 output" as appropriate). 

Generally, a trace output includes trace statements, which are categorized in groups 
and severity levels, so that specific parts of the client program and the server application 
program may be traced as they are executed on the client and the server, to varying degrees 
of detail. Categories may be specific sub-products (e.g. a database driver) or functional 

10 groups (e.g. memory allocation). In one example, the application developer inserts five 

conditional compilation statements into the server application program code that result in the 
generation of trace statements of a particular severity level when a condition is satisfied. The 
five conditional compilation statements are: (1) if a user selects severity level "1" at run- 
time, the trace program will generate trace statements only when fatal errors occur (e.g., 

15 unrecoverable errors that result in terminating the program); (2) if a user selects severity level 
"2" at run-time, the trace program will generate trace statements when non-fatal errors occur 
(e.g., recoverable errors, such as exceptions that are caught and handled, dropped 
connections that can be reestablished, and recoverable database errors); (3) if a user selects 
severity level "3" at run-time, the trace program will generate trace statements for warnings 

20 (e.g., advance notice of impending problems, such as when the program is nearing resource 
or performance limits); (4) if a user selects severity level "4" at run-time, the trace program 
will generate informational trace statements (e.g., documenting program flow); and (5) if a 
user selects severity level "5" at run-time, the trace program will generate trace statements 
for debug purposes (e.g., low-level information used in code debugging or unit testing, such 

25 as local variables, loop variables, branching logic and data passed from the server to the 
client or vice versa). The trace program can be implemented to allow a user (e.g., the 
application developer) to select a severity level for the client-side trace output and the server- 
side trace output at run-time through a server user interface. Because the trace is handled 
separately, different severity levels can be set for the client and the server. 

30 As shown in FIG 2, a system 200 allows a user to interact with a server application 

program 205 running on a server 210 through a user interface 215 rendered by a client 
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program 220 (e.g., a Web browser, a portal application, and the like) running on a client 
device 225. The client device 225 communicates with the server 210 over a network 230, 
which includes, for example, a portion of the Internet. The client device 225 includes a 
display 235 and a client program 220. The client program 220 is configured to communicate 
5 with the server 210 using the network 230 and to render the contents of one or more Web 
pages received from the server 210. The user interface (UI) 215 contains user interface 
elements 215a and 215b, also referred to as controls. A control is a user interface element 
(e.g., 215a) through which a user interacts with, provides input to, and/or controls an 
application (e.g., server application program 205). Some examples of controls are text fields, 

10 radio buttons, tables, trays, and drop-down menus. 

In operation, the server application program 205 generates, maintains, retrieves, 
and/or manipulates data. When the user wants to interact with the server application program 
205, the user initiates interaction, for example, by specifying a URL using the client program 
220. In response to the specified request, the server 210 transmits instructions to the client 

15 program 220 which renders a Web page containing the UI 215 associated with the server 

application program 205. The UI 215 enables a user to view and modify data associated with 
the server application program 205 using the UI elements 215a and 215b. For example, the 
UI element 215a can be a table displaying the names and addresses of employees. 

As described above, trace programs can be used to monitor the execution of 

20 instructions at the client program 220 and the server application program 205 and generate 
trace statements of different severity levels. In one implementation, the trace program is 
provided to the server 210 and the client device 225 in the form of agents 245 and 255. For 
example, the application developer activates a server agent 255 including the trace program 
at the server 210 that performs functions independent from the server application program 

25 205, including functions associated with trace management. The server agent 255 can be 

implemented, for example, using software code that the server application program 205 can 
process and execute. In this way, the server agent 255 adds the functions associated with 
trace management to the server application program 205, which does not normally have these 
functions. 

30 The application developer can also provide a client agent 245 having the trace 

program to the client device 255. Like the server agent 255, the client agent 245 provides 
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enhanced functionality independent of the client program 220. The client agent 245 can be 
implemented, for example, using software code that the client program 220 can process and 
execute. For an example using the Internet and a Web browser client, the client agent 245 
includes executable code that is implemented using JavaScript code. To deliver the 
5 JavaScript code, the server 210 can, for example, embed the JavaScript code directly in a 
Web page or store the code as a separate file that is referenced in a Web page and 
downloaded by the client program 220 when the client program 220 processes that Web page. 
The delivery of the client agent 245 can be separate from the delivery of the UI 215. As part 
of the delivery mechanism, the server 210 can use information about the client device 225 

10 and/or the client program 220 to determine an appropriate client agent 245 for that client 
device 225 and client program 220. For example, a request to the server 210 using HTTP 
includes information about the client device 225 (e.g., processor type, operating system) 
and/or the client program 220 (e.g., browser type, browser version). The server 210 receives 
this information with the request and transmits to the client device 225 a version of the client 

15 agent 245 that is compatible with (i.e., can be executed by) the browser type and version 
included in the information. 

Suppose, for example, that the application developer wants to document the program 
flow of the client program 220 and the server application program 205 as a user interacts 
with the server application program 205 during a testing period defined by the application 

20 developer as a period of time (e.g., minutes, hours or days). The application developer sets 
the severity level of the trace statements to severity level "4" at run-time. The agents 245 
and 255 monitor the execution of server application program 205 instructions at the client 
device 225 and the server 210 as the user interacts with the server application program 205 
and generate trace outputs that exhibit the sequence and results of executing the instructions 

25 at the client device 225 and the server 210. These trace outputs can include, for example, 
trace statements that document events, such as the sending of data (e.g., instructions and 
other information the server 210 transmitted to the client program 220 which the client 
program 220 used to render a Web page containing the UI 215 associated with the server 
application program 205), the receiving of data (e.g., instructions and other information 

30 received by the client program 220 which the client program 220 used to render a Web page), 
the displaying of data (e.g., the client program renders a Web page), and the receiving of user 
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input (e.g., a user modifies data associated with the server application program 205 using the 
UI elements 215a and 215b), to name a few. Once generated, the client agent 245 can 
optionally display the generated client-side trace outputs on a user interface 265 rendered by 
the client agent 245 (e.g., a separate Web browser window) prior to transferring the client- 
5 side trace outputs to the server 210 for integration. 

The transfer may be initiated by the client agent 245 at some point after the client- 
side trace output is generated. For example, the client agent 245 may initiate the transfer 
based upon the passing of a predetermined time period, or the collection of a predetermined 
number of client-side trace outputs. In another example, each time the client program 220 

1 0 - sends a request to the server 2 1 0 (e.g., a request to update data that has been modified by the 
user at the client program 220 so that the data at the client program 220 and the server 
application program 205 are in synchronization), the client agent 245 transfers generated 
client-side trace outputs collected since the previous transfer to the server 210. Alternatively, 
the transfer may be initiated by a command received by the client agent 245 from the server 

15 210, instructing the client agent 245 to transfer generated client-side trace outputs collected 
since the previous transfer. In one implementation, the client agent 245 may be configured to 
transfer the generated client-side trace outputs to a separate buffer that serves as an 
intermediary between the client agent 245 and the server 210. The use of the buffer can free 
the client agent 245 from involvement in the trace output transfer process and allows the 

20 client agent 245 to be implemented using fewer resources. 

The system 200 includes a mechanism that integrates the client-side trace outputs 
with the server-side trace outputs into a single trace output. In one implementation, the 
server agent 255 is configured to integrate the server-side trace outputs with the client-side 
trace outputs it receives from the client agent 245 directly or through the buffer intermediary. 

25 Optionally, the server 210 includes a trace output manager 260 that integrates the server-side 
trace outputs generated by the server agent 255 with the client-side trace outputs generated 
by the client agent 245. In one example, the client-side trace outputs and the server-side 
trace outputs are integrated in chronological order to generate a single trace output file. Each 
time the client program 220 sends a request to the server 205 (e.g., to modify data), the client 

30 agent 245 simultaneously transfers all client-side trace outputs that have been generated since 
the previous client-side trace output transfer to the server 205. Upon receipt of the client-side 
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trace outputs, the trace output manager 260 appends the client-side trace outputs to the 
server-side trace outputs to form an integrated chronological trace output file. In so doing, 
the application developer can view a single trace output file to determine the instruction 
execution sequence first at the server 210, then the client device 225, then back at the server 
5 210, and so on, during the course of a user interaction with the server application program 
205. The server 210 can be configured to transfer the integrated chronological trace output 
file to the client device 225 for display on the user interface 265 rendered by the client agent 
245. 

Optionally, the client device 225 includes a Java applet and/or an ActiveX control 

10 (collectively "active component") that can be executed by the client program 220. Each 

active component 260 can perform interactive animations, immediate calculations, or other 
simple tasks without having to send a user request back to the server 205. The client agent 
245 can be configured to monitor the execution of instructions at the active component 260 
and generate a trace output ("active component trace output") when an event occurs at the 

15 active component 260. The active component 260 can also transfer data for the active 

component trace output to the client agent 245 using a defined API. The client agent 245 can 
be implemented to integrate the active component trace outputs with trace outputs generated 
as a result of monitoring the execution of instructions at the client program 220 ("client 
program trace outputs") to form a client-side trace output. The client agent 245 can then 

20 transfer the client-side trace output to the server 210 for integration with the server-side trace 
output as described above. In an alternative implementation, the client agent 245 transfers 
the active component trace outputs and the client program trace outputs separately. The 
server agent 255 receives the trace outputs from the client device 225 and combines the 
active component trace outputs and the client program trace outputs with the server-side trace 

25 outputs in chronological order to generate a single trace output file. 

In other examples, the client agent 245 and the server agent 255 can be included as 
part of a client-side framework and server-side framework, respectively. Similar to the client 
agent 245 and the server agent 255, the client-side framework and the server-side framework 
are separate from and independent of the server application program 205. The client-side 

30 framework and server-side framework provide additional data management functions at 

client device 225 and server 210 so that the server application program 205 does not have to 
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provide any code or instructions for those additional data management functions. Such 
additional data management functions can include, for example, data type validation for 
inputs, error detection and correction schemes, and user input help. The client-side 
framework and the server-side framework can be implemented using, for example, JavaScript 
5 code. 

In the example shown in FIG 3, a system 300 allows users to interact with a 
multithreaded server application program 305 running on a server 310 through user interfaces 
315a-d rendered by client programs 320a-d (e.g., a Web browser, a portal application, and the 
like) running on client devices 325a-d, respectively. Each client device 325a-d 

10 communicates with the server 310 over a network 330, which includes, for example, a 
portion of the Internet. 

For purposes of the discussion herein, a thread is an independent flow of control that 
operates within the same address space as other independent flows of controls. Multiple 
threads may be grouped into a single entity called a process. In a multiprocessor system, 

15 multiple threads can execute at the same time, one on each processor. There may be multiple 
processes executing, each including multiple threads. A process provides a common address 
space and common system resources, including file descriptors, signal actions, shared 
libraries, and inter-process communication tools. The thread is the schedulable entity. It has 
only those properties that are required to ensure its independent flow of control. 

20 The server application program 305 generates, maintains, retrieves, and/or 

manipulates data. When a user wants to interact with the server application program 305, the 
user initiates interaction, for example, by specifying a URL using the client program 320a. 
In response to the specified request, the server 310 transmits instructions to the client 
program 320a which renders a Web page containing a user interface 315 associated with the 

25 multithreaded server application program 305. For example, the UI 3 1 5 can include a login 
dialog box which requires the user to enter a usemame and password before the server 310 
will allow the user to view and/or modify data associated with the server application program 
305. Once the server 310 has verified the user's identity, the user can begin a user session 
with the multithreaded server application program 305. Generally, a series of requests to a 

30 Web-based server application program originating from the same user at the same browser is 
identified by a unique session identifier and comprises a user session. The session identifier 
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can be tracked as cookies or appended to each request sent to the server 3 10 by a client 
program 320a-d, and allows only authorized users access to the server application program 
305. 

Suppose that the application developer wants to trace the non- fatal errors, for 
5 example, that occur during user sessions in a given testing period. The application developer 
sets the severity level of the trace statements to severity level "2" at run-time and designates 
a two hour window as a testing period. During those two hours, client agents 345a-d residing 
on the client device 325a-d monitor the execution of instructions at the client programs 320a- 
d as the authorized users interact with the server application program 305. Upon detection of 

10 each non- fatal error at a client program 320a, for example, the client agent 345a generates a 
client-side trace output which includes the unique session identifier associated with the user 
session and the sequence and results of executing the instructions at the client device 325a 
that led to the non-fatal error. The client agent 345a then transfers the generated client-side 
trace output to the server 310 (as described above). 

15 Also during those two hours, the server agent 355 on the server 310 monitors the 

execution of instructions by the server application program 305 as one or more authorized 
users interact simultaneously with the server application program 305. The unique session 
identifiers enable the server agent 355 to keep track of which user interaction (i.e., request 
from a client program 320a-d) causes a particular thread of execution in the server 

20 application program 305. Each time the server agent 355 detects a non- fatal error in the 

execution of a thread, the server agent 355 generates a server-side trace output including the 
unique session identifier associated with that particular thread and the sequence and results of 
executing the thread that led to the non- fatal error. In one example, the server agent 355 
integrates the server-side trace outputs with the client-side trace outputs sharing the same 

25 unique session identifier into a single trace output file for each user session at the end of the 
testing period.' 

The techniques described herein can be implemented in digital electronic circuitry, or 
in computer hardware, firmware, software, or in combinations of them. The techniques can 
be implemented as a computer program product, i.e., a computer program tangibly embodied 
30 in an information carrier, e.g., in a machine-readable storage device or in a propagated signal, 
for execution by, or to control the operation of, data processing apparatus, e.g., a 
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programmable processor, a computer, or multiple computers. A computer program can be 
written in any form of programming language, including compiled or interpreted languages, 
and it can be deployed in any form, including as a stand-alone program or as a module, 
component, subroutine, or other unit suitable for use in a computing environment. A 
5 computer program can be deployed to be executed on one computer or on multiple computers 
at one site or distributed across multiple sites and interconnected by a communication 
network. 

Method steps of the techniques described herein can be performed by one or more 
programmable processors executing a computer program to perform functions of the 

10 invention by operating on input data and generating output. Method steps can also be 

performed by, and apparatus of the invention can be implemented as, special purpose logic 
circuitry, e.g., an FPGA (field programmable gate array) or an ASIC (application-specific 
integrated circuit). Modules can refer to portions of the computer program and/or the 
processor/special circuitry that implements that functionality. 

15 Processors suitable for the execution of a computer program include, by way of 

example, both general and special purpose microprocessors, and any one or more processors 
of any kind ofdigital computer. Generally, a processor will receive instructions and data 
from a read-only memory or a random access memory or both. The essential elements of a 
computer are a processor for executing instructions and one or more memory devices for 

20 storing instructions and data. Generally, a computer will also include, or be operatively 

coupled to receive data from or transfer data to, or both, one or more mass storage devices 
for storing data, e.g., magnetic, magneto-optical disks, or optical disks. Information carriers 
suitable for embodying computer program instructions and data include all forms of non- 
volatile memory, including by way of example semiconductor memory devices, e.g., 

25 EPROM, EEPROM, and flash memory devices; magnetic disks, e.g., internal hard disks or 

removable disks; magneto-optical disks; and CD-ROM and DVD-ROM disks. The processor 
and the memory can be supplemented by, or incorporated in special purpose logic circuitry. 

To provide for interaction with a user, the techniques described herein can be 
implemented on a computer having a display device, e.g., a CRT (cathode ray tube) or LCD 

30 (liquid crystal display) monitor, for displaying information to the user and a keyboard and a 
pointing device, e.g., a mouse or a trackball, by which the user can provide input to the 
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computer (e.g., interact with a user interface element, for example, by clicking a button on 
such a pointing device). Other kinds of devices can be used to provide for interaction with a 
user as well; for example, feedback provided to the user can be any form of sensory 
feedback, e.g., visual feedback, auditory feedback, or tactile feedback; and input from the 
user can be received in any form, including acoustic, speech, or tactile input. 

The techniques described herein can be implemented in a distributed computing 
system that includes a back-end component, e.g., as a data server, and/or a middleware 
component, e.g., an application server, and/or a front-end component, e.g., a client computer 
having a graphical user interface and/or a Web browser through which a user can interact 
with an implementation of the invention, or any combination of such back-end, middleware, 
or front-end components. The components of the system can be interconnected by any form 
or medium of digital data communication, e.g., a communication network. Examples of 
communication networks include a local area network ("LAN") and a wide area network 
("WAN"), e.g:, the Internet, and include both wired and wireless networks. 

The computing system can include clients and servers. A client and server are 
generally remote from each other and typically interact over a communication network. The 
relationship of client and server arises by virtue of computer programs running on the 
respective computers and having a client-server relationship to each other. 

Other embodiments are within the scope of the following claims. The following are 
examples for illustration only and not to limit the alternatives in any way. The techniques 
described herein can be performed in a different order and still achieve desirable results. 
Also, although the client agent was described being implemented using JavaScript, other 
languages, including other scripting languages can be used. For example, other scripting 
languages can include JScript and/or other languages compliant with the European Computer 
Manufacturing Associations ECMAScript Language Specification. Although the client agent 
is illustrated as residing in the client program, some or all of the described functionality can 
be distributed in other portions of the client device. Also, in addition to the examples above, 
other portions, or even all of the functionality of the client agent can be incorporated into the 
client program. 

What is claimed is: 
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